[Beta] Get an McpConfig. - Runloop AI Docs

JavaScript

import Runloop from '@runloop/api-client';

const client = new Runloop({
  bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted
});

const mcpConfigView = await client.mcpConfigs.retrieve('id');

console.log(mcpConfigView.id);

import os
from runloop_api_client import Runloop

client = Runloop(
    bearer_token=os.environ.get("RUNLOOP_API_KEY"),  # This is the default and can be omitted
)
mcp_config_view = client.mcp_configs.retrieve(
    "id",
)
print(mcp_config_view.id)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.runloop.ai/v1/mcp-configs/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.runloop.ai/v1/mcp-configs/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.runloop.ai/v1/mcp-configs/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "name": "<string>",
  "endpoint": "<string>",
  "allowed_tools": [
    "<string>"
  ],
  "auth_mechanism": {
    "type": "<string>",
    "key": "<string>"
  },
  "create_time_ms": 123,
  "description": "<string>",
  "custom_headers": [
    {
      "name": "<string>",
      "secret": "<string>",
      "value": "<string>"
    }
  ]
}

GET

/

v1

/

mcp-configs

/

{id}

JavaScript

import Runloop from '@runloop/api-client';

const client = new Runloop({
  bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted
});

const mcpConfigView = await client.mcpConfigs.retrieve('id');

console.log(mcpConfigView.id);

import os
from runloop_api_client import Runloop

client = Runloop(
    bearer_token=os.environ.get("RUNLOOP_API_KEY"),  # This is the default and can be omitted
)
mcp_config_view = client.mcp_configs.retrieve(
    "id",
)
print(mcp_config_view.id)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.runloop.ai/v1/mcp-configs/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.runloop.ai/v1/mcp-configs/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.runloop.ai/v1/mcp-configs/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "name": "<string>",
  "endpoint": "<string>",
  "allowed_tools": [
    "<string>"
  ],
  "auth_mechanism": {
    "type": "<string>",
    "key": "<string>"
  },
  "create_time_ms": 123,
  "description": "<string>",
  "custom_headers": [
    {
      "name": "<string>",
      "secret": "<string>",
      "value": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id

string

required

The unique identifier of the McpConfig.

Response

Successfully retrieved the McpConfig.

An McpConfig defines a configuration for connecting to an upstream MCP (Model Context Protocol) server. It specifies the target endpoint and which tools are allowed.

id

string

required

The unique identifier of the McpConfig.

name

string

required

The human-readable name of the McpConfig. Unique per account.

endpoint

string

required

The target MCP server endpoint URL (e.g., 'https://mcp.example.com').

allowed_tools

string[]

required

Glob patterns specifying which tools are allowed from this MCP server (e.g., ['github.search_', 'github.get_'] or ['*'] for all tools).

auth_mechanism

object

required

How the primary credential is applied to upstream requests.

Show child attributes

create_time_ms

integer<int64>

required

Creation time of the McpConfig (Unix timestamp in milliseconds).

description

string | null

Optional description for this MCP configuration.

custom_headers

object[] | null

Additional headers applied to upstream requests after the credential. Secret-backed entries reference the secret by 'sec_' id; values are never returned.

Show child attributes